home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / rlog_125.zip / REMOTLOG.DOC < prev    next >
Text File  |  1990-08-02  |  15KB  |  440 lines
  1.                                     
  2.  
  3.  
  4.  
  5.                          R E M O T E   A C C E S S
  6.  
  7.  
  8.                   L O G  R E P O R T I N G  P R O G R A M
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                 REMOTLOG
  15.  
  16.    //////    /////  /      /  ///////  ///////   /        ///////  ///////
  17.    /     /   /      / /   //  /     /     /      /        /     /  /
  18.    //////    ///    /   /  /  /     /     /      /        /     /  /   ///
  19.    /     /   /      /      /  /     /     /      /        /     /  /     /
  20.    /      /  /////  /      /  ///////     /      ///////  ///////  ///////
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. The Program  - Remotlog
  68.  
  69.  
  70.         I developed Remotlog because when the announcement of RA was made and I
  71.         endeavored to switch from QuickBBS.  There was something missing.  I
  72.         could no longer use all my QBBS utilities.  After exhaustive efforts of
  73.         trying to get the implementation of my old program by its author, I
  74.         decided that it was time to do some coding.
  75.  
  76.         Here we have the finished product.  A full fledged RA log reporting
  77.         program.  This program is in no way crippled.  And never will be.
  78.  
  79.  
  80.  
  81.         RA is the registered product of Continental Software.
  82.         QuickBBS is the registered product of The QuickBBS Support Group.
  83.  
  84.  
  85.         At present this program will function with RA version 0.02.  It should
  86.         have no problems with 0.03 but will have to wait till its release.
  87.  
  88.         Do not attempt to use this program with any other software except RA
  89.         because it uses the file MESSAGES.RA.  If it cannot find this file the
  90.         program will abort in error.
  91.  
  92.         The screens provided by this program are as the author thought you
  93.         the sysops would like to see.  If you feel the information is too much
  94.         or that there is not enough, or would even like to see some of the
  95.         information moved from one location to another part of the page or a
  96.         totaly different screen.  Please do not hesitate to let the author
  97.         know.
  98.  
  99.  
  100.  
  101.  
  102. Configuration of Remotlog
  103.  
  104.         A copy of exactly how the configuration file looks is included with the
  105.         zipped package.  Here is a line by line definition.  The configuration
  106.         file is called REMOTLOG.CFG.
  107.  
  108. ;-------------------------------------------------------------------------
  109. ;                       Remotlog Configuration file
  110. ;                        By Orland Carter 1:135/72
  111. ;-------------------------------------------------------------------------
  112. ;
  113. ;-------------------------------------------------------------------------
  114. ; This is a required entry.  It tells the program the [path + filename] of
  115. ; the Log file to be processed.
  116. ; DEFAULT : SYSTEM.LOG
  117. ;-------------------------------------------------------------------------
  118. ;
  119. LogFile SYSTEM.LOG
  120. ;
  121. ;-------------------------------------------------------------------------
  122. ; This option is required if you want REMOTLOG to process the file Xfers
  123. ; against the files counter for a good downloaded count.  The DEFAULT is
  124. ; NOFDLOGFILE  the other option is FDLOGFILE \.......\  where \..\ is the
  125. ; [Path + Filename] of the FD log file.
  126. ;-------------------------------------------------------------------------
  127. ;
  128. FDLogFile C:\Fd\Fd.Log
  129. ;
  130. ;-------------------------------------------------------------------------
  131. ; This option is required.  It tells the program what the Dos Shell entry
  132. ; of your External chat program is.  This must be the same case as the
  133. ; BBS writes it to the log file.  Required whether you have one or not.
  134. ; DEFAULT : FX-CHAT.EXE
  135. ;-------------------------------------------------------------------------
  136. ;
  137. ExternalChat FastChat.EXE
  138. ;
  139. ;-------------------------------------------------------------------------
  140. ; This option is required.  It tells the program what [path + filename]
  141. ; the output of the program should be placed in. *.asc/*.ans versions.
  142. ; DEFAULT : REMOTLOG
  143. ;-------------------------------------------------------------------------
  144. ;
  145. Outputfile c:\RA\Txt\Remotlog
  146. ;
  147. ;-------------------------------------------------------------------------
  148. ; This option is required.  It tells the program which color to place the
  149. ; background of the ansi screen in.
  150. ; DEFAULT : 40
  151. ;-------------------------------------------------------------------------
  152. ;
  153. Back 40
  154. ;
  155. ;-------------------------------------------------------------------------
  156. ; This option is required.  It tells the program what color the numbers
  157. ; displayed are.
  158. ; DEFAULT : 1;33
  159. ;-------------------------------------------------------------------------
  160. ;
  161. Numbers 1;33
  162. ;
  163. ;-------------------------------------------------------------------------
  164. ; This option is required.  It tells the program what color to use when
  165. ; highlighting the Beginning and Ending dates of the Log period.
  166. ; DEFAULT : 1;46;37
  167. ;-------------------------------------------------------------------------
  168. ;
  169. HighLight 1;46;37
  170. ;
  171. ;-------------------------------------------------------------------------
  172. ; This option is required.  It tells the program which color to use to
  173. ; restore the screen to "normal".
  174. ; DEFAULT : 0
  175. ;-------------------------------------------------------------------------
  176. ;
  177. Normal 0
  178. ;
  179. ;-------------------------------------------------------------------------
  180. ; This option is required.  It tells the program which color to use for
  181. ; Outlining the Box and Dividing lines of the output file.
  182. ; DEFAULT 1;34
  183. ;-------------------------------------------------------------------------
  184. ;
  185. Outline 1;34
  186. ;
  187. ;-------------------------------------------------------------------------
  188. ; This option is required.  It tells the program which color to use for
  189. ; all the text that is printed.
  190. ; DEFAULT 0;32
  191. ;-------------------------------------------------------------------------
  192. ;
  193. Text 0;32
  194. ;
  195. ;-------------------------------------------------------------------------
  196. ; This option is required.  It tells the program whether or not you wish
  197. ; the optional page of Multiline usage to be displayed.  The statistics
  198. ; will still be stored if the option is not selected.
  199. ; DEFAULT : NOMULTILINE
  200. ;-------------------------------------------------------------------------
  201. ;
  202. NoMultiLine
  203. ;
  204. ;-------------------------------------------------------------------------
  205. ; This option is required.  It telss the program what type of log file
  206. ; You are using.  Wheter FD [Front Door type] or OPUS.
  207. ; DEFAULT FD
  208. ;-------------------------------------------------------------------------
  209. ;
  210. FD
  211. ;
  212. ;-------------------------------------------------------------------------
  213. ; This option is not required and at the descretion of the sysop.  Using
  214. ; This will cause another page to be displayed in addition to the current
  215. ; 2 or 3 pages that are already displayed.  This option is where the sysop
  216. ; Can have remotlog search the logfile for something specific and keep
  217. ; track of its occurrences.
  218. ; I.e. *01My_Name Carter      - This will cause remotlog to search the log
  219. ; file for all occurences of "Carter" it will accumulate and store the
  220. ; amount of time it finds it in variable 01.  When it displays it it will
  221. ; display "My_Name >>> ####" where # is amount of times the item was found
  222. ; Possible Variables are 00-10.  The 0 is significant.  The "*" is required
  223. ; There can be no spaces except to separate the Display item from the
  224. ; Search item.
  225. ; Format "*<Variable 00-10><Entry to Make in *.Ans/*.Asc file> <Search For>"
  226. ;         *00My_Name Carter
  227. ;-------------------------------------------------------------------------
  228. ;
  229. ;*00My_Last_Name  Carter
  230. ;*01My_First_Name Orland
  231. ;
  232. ;-------------------------------------------------------------------------
  233. ; These options are not required.  But they do provide you with a great
  234. ; amount of security.  For areas you do not want all your users to see.
  235. ; IE. Adult areas or Sysop areas.
  236. ; DEFAULT - NONE.  200 MAXIMUM ENTRIES.
  237. ;-------------------------------------------------------------------------
  238. ;
  239. NoShow  8
  240. NoShow 10
  241. NoShow 12
  242. NoShow 19
  243. NoShow 36
  244. NoShow 45
  245. NoShow 49
  246. NoShow 50
  247. NoShow 51
  248. ;
  249. ;-------------------------------------------------------------------------
  250. ; This option is not required.  It is used to Change the default Sealink
  251. ; protocol displayed in the 1st output page to a protocol of your choosing.
  252. ; REPLACESEA - Is the Search String for the new protocol.
  253. ; REPLACEDSP - Is the Actual Item to be displayed in the Output page.
  254. ;-------------------------------------------------------------------------
  255. ;
  256. ;ReplaceSea SEALink
  257. ;ReplaceDsp SEALink
  258. ;
  259. ;-------------------------------------------------------------------------
  260. ; This option is also not required.  It determines whether or not the local
  261. ; logons will be shown on the report output.  The DEFAULT for this option
  262. ; is show local logons.  Leave this option out for the default to take
  263. ; effect.
  264. ;-------------------------------------------------------------------------
  265. ;
  266. ;NoLocal
  267. ;
  268. ;-------------------------------------------------------------------------
  269. ; This option is also not required.  It activates or deactivates the
  270. ; Files.BBS downloaded files counter.  The count will be stored and added
  271. ; to the Files.BBS in the directory the file was taken from.  DEFAULT for
  272. ; This option is FILECOUNTER,     To deactivate use NOFILECOUNT
  273. ;-------------------------------------------------------------------------
  274. ;
  275. FILECOUNTER
  276. ;
  277. ;-------------------------------------------------------------------------
  278. ; This option is also not required.  It activates a chat record.  This will
  279. ; log all chats found in the log file to a file called REMOTLOG.CHT in the
  280. ; current directory.  The DEFAULT is CHATRECORD, all chats will be logged.
  281. ; The other option to disable the chat is NOCHATRECORD
  282. ; A file is created named REMOTLOG.CHT
  283. ;-------------------------------------------------------------------------
  284. ;
  285. CHATRECORD
  286. ;
  287. ;-------------------------------------------------------------------------
  288. ; This option is also not required.  It activates or Deactivates the log
  289. ; deleting option.  The DEFAULT is the log will be deleted every 10 days.
  290. ; The two options are DELTELOG ## (Where ## is days log should be kept.)
  291. ; and NODELETELOG.
  292. ;-------------------------------------------------------------------------
  293. ;
  294. DELETELOG 7
  295. ;
  296. ;-------------------------------------------------------------------------
  297. ; This option is also not required.  It activates or Deactivates the log
  298. ; deleting option.  The DEFAULT is the fd log will be deleted with the RA log.
  299. ; The two options are DELTEFDLOG and NODELETEFDLOG.
  300. ;-------------------------------------------------------------------------
  301. ;
  302. DELETEFDLOG
  303. ;
  304. ;-------------------------------------------------------------------------
  305. ; This option is also not required.  It will determine whether or not the
  306. ; Log file actually gets deleted or zipped up and given an individual date
  307. ; for storage.  The zip method used is PKZIP.  any version.  The file will
  308. ; be moved while zipped.  The zipped name will be in the format RLOGMMDD.0YY
  309. ; This option will not function if the Delete log option is disabled.
  310. ; Pkzip must be in the current directory or properly pathed.
  311. ; DEFAULT - NOZIPFILE           other otion is ZIPFILE
  312. ;-------------------------------------------------------------------------
  313. ;
  314. ZIPFILE
  315. ;
  316. ;-------------------------------------------------------------------------
  317. ;          E N D    O F    R E M O T L O G . C F G   F I L E
  318. ;-------------------------------------------------------------------------
  319.  
  320.  
  321. Here is a quick Batch file example to demonstrate the use of the Chat logging
  322. feature.
  323.  
  324. Batch File .........
  325. Echo make master Directory
  326.      REMOTLOG
  327.      Mbutil Post Remotlog.Cht #28 -To "Orland Carter" -From "Remotlog" -Subject "Chat Requests"
  328.      Del Remotlog.cht
  329.      MSTRDIR
  330.      ren mstrdir.cfg *.tmp
  331.      ren mstrdir.g   *.cfg
  332.      MSTRDIR
  333.      ren mstrdir.cfg *.g
  334.      ren mstrdir.tmp *.cfg
  335. End Of Batch File....................
  336.  
  337.  
  338.  
  339.  
  340.  
  341. Supplied ANSI Code sequences
  342.  
  343. Number  Represents
  344. ------  ----------
  345. 0       All attributes off  (Normal Display)
  346.  
  347. 1       High Intensity (Bold)
  348.  
  349. 5       Sets Blink on
  350.  
  351. 7       Reverse Video on
  352.  
  353. 8       Concealed on (makes display invisible)
  354.  
  355. 30      Foreground      Black
  356.  
  357. 31                      Red
  358.  
  359. 32                      Green
  360.  
  361. 33                      Yellow
  362.  
  363. 34                      Blue on Color Monitor
  364.                         Underline on MonoChrome
  365.  
  366. 35                      Magenta
  367.  
  368. 36                      Cyan
  369.  
  370. 37                      White
  371.  
  372. 40      BackGround      Black
  373.  
  374. 41                      Red
  375.  
  376. 42                      Green
  377.  
  378. 43                      Yellow
  379.  
  380. 44                      Blue
  381.  
  382. 45                      Magenta
  383.  
  384. 46                      Cyan
  385.  
  386. 47                      White
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393. Hints about operation of this program
  394.  
  395.   There are several different things that you can do to get certain results
  396.   from this program.
  397.  
  398.    For example if you want to change the beging date of the report without
  399.    erasing the remotlog.dat file.  All you have to do is to edit the .DAT file
  400.    find the string that has the date in it and make it a null string.  When the
  401.    program starts up it will notice the date is missing and get the date from
  402.    the current system.log file.
  403.  
  404.    When reading the log file the program will not attempt to reposition pointers
  405.    if the last item in the log is that REMOTLOG has checked the log.  Of course
  406.    the current session will be appended to the end of the logfile.
  407.  
  408.    By deleting the notations that REMOTLOG makes in the log file you can force
  409.    it to re-process the log file.
  410.  
  411.    Any bug reports, comments, or requested addition, deletions etc. may be sent
  412.    to Node 1:135/72.  or the address listed in the donations section.  I can
  413.    also be reached in the RA_SUPPORT echo.
  414.  
  415.  
  416.  
  417. Credits
  418.  
  419.    The author, Orland K. Carter, would like to thank my beta testers of
  420.    this program that put up with the constant updates to the one program and
  421.    major overhaul of their configuration and data files.
  422.  
  423.    Daniel Johnston, and Robert Taylor, Peter Janssens thank you for your
  424.    patience, and help in beta testing this program.
  425.  
  426.  
  427. Donations
  428.  
  429.    A donation if you wish can be made to the author.
  430.  ____________________________________________________________________________
  431. |Make all donations address to                                               |
  432. |  Orland K. Carter, REMOTLOG                                                |
  433. |  2850 N.W. 155 Terrace                                                     |
  434. |  Opa-Locka, FL  33054-2223                                                 |
  435. |____________________________________________________________________________|
  436.  
  437. Thank you for your support.
  438.  
  439.         Orland
  440.